QMSI Pascal-1 Installation Procsdurss 


OMSI Pascal-1 VI.2 
for RTl1 V2f V3t V4 


Contents of the Distribution Medium 


Each medium contains a complete set of distribution files. 

Below is a list of these files with a brief explanation of each 


Installation files 


IN8TAL.DOC 

Installation documentation 

INSTAL.8AV 

Installation program 

Documentation 

files 

USER .DOC 

User's Manual 

PA8CAL.DOC 

Language Specification 

DEBUG .DOC 

Debugger Manual 

GUIDE .DOC 

Programmer’s Guide 

Pascal compilers 


PASFPP.SAV Compiler for FPP machines 

PASSIM.SAV Compiler for non-FPP machines 


Pascal utility programs 


PASFMT.PA8 
IMP .PAS 
PROFIL.PAS 
PCL .PAS 
ERROR .PAS 
STRING.PAS 
INTRPT.PAS 
CSI .PAS 
MACEIS.SAV 
MAC8IM.SAV 


Formatter and cross reference 
Post-compilation optimizer 
Program profiler 

Pascal command language interpreter 
System ErrorC) procedure 
String manipulation procedures 
Interrupt handling examples 
Interface for .CSIGEN 
Fast assembler for EIS machines 
Fast assembler for non-EIS machines 


Pascal object libraries 


LIBFPP.V3/.V2 

LIBFI8.V3/.V2 

LIBEIS.V3/.V2 

LIB8IM.V3/.V2 


Library 

Library 

Library 

Library 


for FPP on RTll V3/V2 
for FIS on RT11 V3/V2 
for EIS on RTl1 V3/V2 
for non-EIS on RT11 V3/V2 


■ ’ . . * 


> **V. 
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Debugger modules 


0FPP.V3/.V2* ... *9FPP.V3/.V2»AFPP.V3/.V2»BFPP.V3/.V2 

FPP debugger modules for RT11 V3/V2 
0SIM.V3/.V2* ... *9SIM.V3/.V2*ASIM.V3/.V2*B8IH.V3/.V2 

Non-FPP debugger modules for RT11 V3/V2 

V.. '-•» • ■ «r T V '• :■ ' , 

Demonstration programs 


HEARTS.PAS 
CHECKR.PAS 
PLO .PAS 
RANDOM.PAS 
MAZE .PAS 


The game of Hearts 
A game of checkers 
PL/O - a simple compiler 
Random number generator 
Amazing Demonstration 



Installation Preparation 

For RT11 V3 and V4» the OMSI Pascal VI.2 system is installed by an 
automatic configuration procedure. For RT11 V2t the procedure is 
only partially automated. 

Several system programs supplied by DEC are required for 
installation of Pascal and for use by the Pascal system. These 
programs are the PIP.SAV file transfer utility* the MACRO.SAV 
assembler* and the LINK.SAV linking loader. You should verify 
that these programs are on your system disk. 


\ 


P* 
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QMSI Pascal-1 VI.2 Installation for RTll 

Installation Dialogu* 


Installation Dialogua 

Th* installation procedure builds Pascal on a singla targat disk. 
Th* targat disk must contain at laast 544 fra* blacks if no 
documantation or damonstrations ar* dasirad. Th* documantation 
filas raquira 245 blocks of storage* while th* damonstrat ion files 
use 175 blocks* or 964 total blocks. 

To start the installation process* type* 

.RU Kxn> INSTAL 

where xxn> is th* device name and unit number of th* distribution 
medium. This starts th* installation procedure* which will ask 
savaral questions. Th* default answer is given in parenthes* at 
th* end of each question and will be used when you respond with 
only a carrage return. Below are th* questions and a description 
of each. 

DEVICE FOR THE DISTRIBUTION MEDIUM CMTD ? 

Enter the device name and unit number on which the Pascal 
distribution medium is mounted. If the device is "MT*"* a 
carriage return will use this name as default. 

DEVICE FOR THE TARGET DISK CSY*> ? 

Enter th* device name and unit number of the disk on which 
Pascal is to be installed. 

INCLUDE DEMONSTRATION PROGRAMS AND DOCUMENTATION (YES) ? 

If answered affirmatively* the demonstration programs and 
documentation files are included in the system 
installation procedure. 

USE THE CURRENT SYSTEM’S CONFIGURATION <YEB) 7 

If answered affirmatively* th* version of RTll and the 
math hardware on th* current system are used in 
configuring Pascal* and the following quest 
omitted. 

VERSION OF RTll TO BE USED <n> ? 

Answer "4" if Pascal is to run os RTll V4. Answer "3" if 
Pascal is to run on RTll V3. Answer *2" if Pascal is to 
run on RTll V2. Th* default will be -the current version 
of RTll. The same Pascal system is used ter RTll V3 or 
V4. 

IS FPP HARDWARE TO BE USED <YES/NO> ? 
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If you will be using a machine with an FP11 floating point 
processor* answer yes« otherwise no. If yes* then the 
next two questions are skipped. The default will be the 
current system’s configuration. 

18 FIS HARDWARE TO BE U8ED (YE8/N0) ? 

If you will be using a machine with a PDP-11/40 style 
floating point instruction set answer yes* otherwise no. 
If yes* then the next question is skipped. The default 
will be the current system's configuration. 

IS EI8 HARDWARE TO BE USED (YES/NO) ? 

If you will be using a machine with an extended 
instruction set for integer operations answer yes* 
otherwise no. The default will be the current system’s 
configuration. 
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Installation Dialogue 


After these questions have been answered! the configuration to be 
installed will be printed! as in the example! 

CONFIGURATION BEING INSTALLED 
SOURCE! MT: 

TARGET! RK2! 

RT11! V3 
MATH! EIS 

The installation program will then proceed to copy the files from 
the distribution medium to the target device. 

For floppy and DECtape distribution! the installation program will 
prompt the user to mount the next volume when needed. 

After all files have been copied! several programs need to be 
compiled. These are PASFMT.PAS! the Pascal text formatter! 
IMP.PASi the macro code improver! PCL.PAS! the Pascal command 
interpreter! and PROFIL.PAS! the Pascal program profiler object 
module. For RT11 V3 and V4! an indirect command file 
automatically compiles these programs. For RT11 V2 or floppy 
drive systems! these programs must be compiled by typing commands 
on the console terminal as shown in appendix A. 

If using RTil V3 or V4! customizing of the Pascal command language 
program PCL! as described in appendix C! will be necessary if the 
target device is other than the system disk. 


Installation on systems with floppy disk drives! 


If your system uses single—density drives as main storage 
then you must build Pascal-1 manually. To generate Pascal 
you must select a compiler from PASFPP.8AV or PASSIM.SAV and 
call it PASCAL.SAV. You must also select a support library 
from LIBFI8.V2/V3! LIBEIS.V2/V3! or LIBSIM.V2/V3 and call it 
PASCAL.OBJ. The debugger consists of 12 object modules that 
must be placed on your system as A.OBJi B.OBJ! 
0.OBJ!...!?.OBJ. The distribution kit contains debugger 
modules for RT11 versions 2 and 3/4 supporting FPP and 
FIS/EIS/SIM floating point hardware. Choose those 12 files 
appropriate to your system. After transferring the files 
given above! you have a Pascal system capable of compiling! 
assembling! linking! debugging! and executing Pascal 
programs. The utilities! PASFMT! IMP! PCL! PROFIL! and 
STRING may be stored on another device and called when 
needed. 


If your system has double-density drives with at least 544 
free blocks! you may use the automated installation driver! 
INSTAL.SAVi to partially build your Pascal system. The 
installation procedure will run out of space shortly after 
creating the indirect command file! PASCAL.COM. The steps 
usually performed in this command file must now be done 
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Installation Dialogue 



manually using an additional drive for intermediate 
All files used by Pascal-1 VI.2 can be stored on 
disk. 

With either single-density or double-density drive 
follow the sample installation given in appendix A. 



files. 

system 

systems 
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Sample Installation 

This installation is from magtape to the system disk on RT11 V3 
with FPP. The "<cr>" means that a carriage return was the only 
response. 

.RU MTlINSTAL 

INSTAL - System installation for OMSI Pascal-1 VI.2 on RT11 

In answering the following questions* a default answer is 
given in parentheses. The default will be used when 
just the return key is pressed. For details about the 
question* type a •?•I otherwise type the dssired response. 

Device for the distribution medium (MT*> ? <cr> 

Device far the target disk CSY«> ? <cr> 

Include demonstration programs and documentation (YES) ? <cr> 

Use current system’s configuration (YES) ? <cr> 

Configuration being installedi 
SOURCE* MT* 

TARGETS SYl 
RT11 * V3 
MATH* FPP 


Copying 


files* 





MT * USER 

.DOC 

to 

SY > USER 

.DOC 

MT*PASCAL 

.DOC 

to 

SYlPASCAL 

.DOC 

MT*DEBUG 

.DOC 

to 

SY * DEBUG 

.DOC 

MTiGUIDE 

.DOC 

to 

SYtGUIDE 

.DOC 

MT * PASFPP 

.SAV 

to 

SY * PASCAL 

.SAV 

MTtMACEIS 

.SAV 

to 

SY * MAC 

.SAV 

MT*LIBFPP 

.OBJ 

to 

SY * PASCAL 

.OBJ 

MT*AFPP 

■ V3 

to 

SY* A 

.OBJ 

MT*BFPP 

. V3 

to 

SY*B 

.OBJ 

MT»OFPP 

. V3 

to 

SY*0 

.OBJ 

MT»1FPP 

. V3 

to 

SY* 1 

.OBJ 

MTJ2FPP 

. V3 

to 

SY * 2 

.OBJ 

MT * 3FPP 

. V3 

to 

SY * 3 

.OBJ 

MT*4FPP 

. V3 

to 

SY * 4 

.OBJ 

MTsSFPP 

. V3 

to 

SY * 5 

.OBJ 

MT*6FPP 

. V3 

to 

SY* 6 

.OBJ 

MTS7FPP 

. V3 

to 

SY * 7 

.OBJ 

MT*8FPP 

. V3 

to 

SY s 8 

.OBJ 

MT*9FPP 

. V3 

to 

SY*9 

.OBJ 

MT*PASFMT 

.PAS 

to 

SY * PASFMT 

.PAS 

MT * IMP 

.PAS 

to 

8Y* IMP 

.PAS 

MT* PROFIL 

.PAS 

to 

SY*PROFIL 

.PAS 

MT * PCL 

.PAS 

to 

SY*PCL 

.PAS 

MTtSTRING 

.PAS 

to 

8Y*8TRING 

.PAS 
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MT*HEARTS.PAS to 
HTiCHECKR.PAS to 
MTIRANDOM.PAS to 
MTlMAZE .PAS to 


SYiHEARTS.PAS 
BYtCHECKR.PAS 
BY*RANDOM.PAS 
SYtMAZE .PAS 


All files have been copied - beginning compilations 


After all these files have been copied* the installation program 
creates the indirect command file PASCAL.COM* which then compiles 
the Pascal source programs. The compilation process is not shown 
here for reasons of brevity. For RT11 V2 users this command file 
will not be created I the user must do the following steps to 
compile the supplied source programs. 

.ASS yyn DK (yyn* is the target device) 

.RU PASCAL 

♦PA3FMT-PASFMT 

.RU PASCAL 

♦IMP-IMP 

.RU PASCAL 

♦PROFIL-PROFIL 

.RU PASCAL 

♦ PCL-STRING* PCL 
.R MACRO 
♦PASFMT-PASFMT 
♦IMP-IMP 
♦PROFIL-PROFIL 
♦PCL-PCL 

♦tc 

.R LINK 

♦ PASFMT-PASFMT»PASCAL 
♦IMP-IMP.PASCAL 

♦ PCL-PCL.PASCAL/M s 60000 

♦tc 

.R PIP 

♦ PASFMT.PAS.PASFMT.MAC.PASFMT.OBJ»IMP.PAS.IMP.MAC * IMP.OBJ/D 

♦ PROFIL.PAS»PROFIL.MAC» PCL.MAC.PCL.OBJ/D 

♦tc 

and if the demonstration programs are included* 


.RU PASCAL 

♦HEARTS-HEARTS 

.RU PASCAL 

♦CHECKR-CHECKR 

.RU PASCAL 

♦MAZE-MAZE 

.R MACRO 

♦HEARTS-HEARTS 

♦CHECKR-CHECKR 

♦MAZE-MAZE 

♦tc 

.R LINK 
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Appendix Ai Sample Installation 


♦HEARTS-HEARTS»PASCAL 
♦CHECKR*CHECKR»PASCAL 
♦MAZE-MAZE.PASCAL 

*tc 

• R PIP 

♦HEARTS.MAC«HEARTS.OBJiCHECKR.MAC * CHECKR.OBJ/D 

♦MAZE.MAC.MAZE.OBJ/D 

♦tC 


\ 




* 
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Appendix B* Programming Changes in OMSI Pascal-1 VI.2 


Programming Changes in QHSI Pascal-1 VI.2 


Four specific language features have been changed from VI.I to 
VI.2* all of which are related to I/O characteristics. If a 
program that was written using VI.1 fails to operate properly with 
VI.2* check the following points* 


(!) In VI.1. EolnO on interactive terminal files had the initial 
value True. This has changed to False in VI.2. 

Symptom* Program "hangs"* or ignores the first input line. 

Cure* Remove the initial ReadlnO* or replace it by the statement 
"if EolnO then ReadlnO"* which runs correctly with either 
version. 

(2) The VI.1 ReadO procedure* when reading a (packed) array of 
Char* ignored leading blanks and terminated on a blank or a 
comma. The VI.2 ReadO procedure will read characters without 
skipping blanks* and terminates at EolnO or when the array is 
filled. 

Symptom* Program does not interpret commands properly* or loops. 

Cure* Reprogram sections that use the VI. 1 ReadO. Programs that 
are heavily dependent on the VI.1 style ReadO may be more 
easily recoded using the VI.2 string package. 


(3) The declaration "file of Char" is no longer equivalent to the 
declaration "Text". This change corresponds to the more 
strict type checking of the draft ISO Pascal Standard. 

Symptom* Compiler error message “TEXT file expected". 

Cure* Substitute the type Text and recompile. 

(4) The SeekO* DepositO* and CloseRandomFilet) procedures 

supplied with VI.1 have been superseded by the built-in 
procedure SeekO. 

Symptom* Unpredictable I/O failures. The VI.1 procedures will 
compile under VI.2* but will not operate correctly. 

Cure* Reprogram affected sections using the built-in SeekO. 
Note that the VI.2 SeekO numbers file records beginning at 1. 
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Appendix C* Customizing PCL 


Customizing the Pascal command language program PCL 


For sites using RT11 V3 or V4» The Pascal command language program 
PCL can be used to automate the compilation process. PCL accepts 
a line of input in standard CSX format and produces an indirect 
command file to perform the compilation* assembly* linking* and 
start-up of a program. 

When OMSI Pascal-1 is installed on the system disk* PCL Mill need 
no modification! the PCL.SAV created in the installation 
procedure will work correctly. 

If OMSI Pascal-1 is to be on a non-system disk* PCL.PAS will need 
modification and recompilation. The editing can be done with a 
standard text editor. Change the first line of PCL.PAS to» 

PascalDevice * ’yyn* ? ! (* Device for the Pascal files *> 

where yyni is the device name and unit number on which the Pascal 
files can be found. After this change has been made* recompile 
PCL with the following commands! 

.ASS yyn DK 
.RU PASCAL 
#PCL«PCL 
.MAC PCL 

.LINK PCL*PASCAL/STACKl60000 























